home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / qcom293b.zip / QCOM.DOC < prev    next >
Text File  |  1992-07-27  |  42KB  |  982 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.        QCOM.EXE
  8.        Revision 2.93
  9.        July 11, 1992
  10.  
  11.  
  12.        ------------------------------------------
  13.  
  14.  
  15.  
  16.        Copyright 1990-1992 by RTFM Software and Richard W. Turenne
  17.        Winnipeg, Mb.
  18.        All Rights Reserved
  19.  
  20.  
  21.  
  22.        All users are granted a limited license to try QCom for a reasonable
  23.        evaluation period to determine its' suitability.
  24.  
  25.  
  26.        QCom is USER SUPPORTED.  It is not Public Domain and is not free.
  27.        This means, if you decide to use this program, please show your
  28.        support by registering it with the author.
  29.  
  30.  
  31.        To add INCENTIVE, those who register will be shown how to utilize
  32.        the user defineable functions.  Users can pre-define other
  33.        external dos functions, or other external protocols, or batch files,
  34.        and access them with a single keystroke.  Additionally, they will be
  35.        able to eliminate the "nag" screen when ending QCom.
  36.  
  37.  
  38.  
  39.  
  40.  
  41.        ------------------------------------------------------------------
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.   SYSTEM REQUIREMENTS:
  57.  
  58.      Minimum of one floppy drive, 256K or more memory, and a modem of
  59.      course.
  60.  
  61.  
  62.   INTRODUCTION to QCom:
  63.  
  64.      QCOM is a compact communications program that attempts to pack in
  65.      maximum of function, form and ease of use into a small package.  It
  66.      was decided to primarily use external protocols for files transfers
  67.      because there are many available from which to choose.  And as the
  68.      technology of protocols progresses, it's a simple matter to keep your
  69.      communication software operating at the current state of the art.
  70.  
  71.      Note: All references to DSZ also apply to GSZ by Omen Technology.
  72.  
  73.      QCOM is tailored to use the shareware program DSZ by Omen Technology
  74.      to handle most file transfers.  When a file is to be transferred,
  75.      QCOM passes the proper commandline to DSZ which then handles all the
  76.      work of transferring and error checking.  It provides commonly used
  77.      Xmodem, Ymodem and Zmodem transfer methods.
  78.      (QCom can also be set up to use any other external protocol. See the
  79.      section on OTHER EXTERNAL PROTOCOLS.)
  80.  
  81.      When the file transfer is finished, QCOM resumes control.
  82.      NOTE:
  83.      DSZ.COM  must be present in the default directory or in the DOS
  84.      path if you wish to transfer files.  DSZ or GSZ  may be obtained from
  85.      many local online sources.
  86.  
  87.  
  88.  
  89.  
  90.   FIRST TIME SETUP AND CONFIGURATION:
  91.  
  92.     Run the QCom Setup utility called QS.EXE.  Enter Com Port, screen
  93.     colors and select your modem from the list.  Pressing ENTER will
  94.     update the QCom configuration file.  Follow any instructions
  95.     relating to modem switches or jumpers.
  96.  
  97.     Run QCOM.  Wait a few moments while the modem is being initialized.
  98.     An error message usually means the modem has not been properly
  99.     initialized.  Correct modem initialization is critical to all
  100.     operations that involve the modem.  If the string from QCom Setup
  101.     is incorrect, please advise the author so that corrections can be
  102.     made.
  103.  
  104.     In the mean time, you may need to refer to your modem instruction
  105.     manual if you still have problems.  One way to check initialization
  106.     is to press ALT-M when at the terminal screen to reinitialize the
  107.     modem.
  108.     If you get "ERROR" back from the modem then there is something in the
  109.     string that it doesn't understand. Refer to your modem manual to
  110.     remove any incorrect modem commands from the string.  Pressing ALT-O
  111.     when in QCom allows you to edit the modem string contained in the
  112.     configuration file.  Also see the Trouble Shooting section that
  113.     follows later.
  114.  
  115.     All configuration data is stored in the text file called QCOM.CFG.
  116.     If you wish, you can edit the file with any ascii editor as long as a
  117.     few rules are adhered to:
  118.  
  119.     a)The sequence and number of items in the file must not be altered.
  120.  
  121.     b)Each line should be no longer than 80 characters.  Longer lines
  122.       are truncated to 80 characters.
  123.  
  124.     c)Comments, if used, must be kept behind semicolons.
  125.  
  126.     d)The editor must not insert any hidden formatting or control
  127.       characters into the text.  If in doubt about your editor, edit it
  128.       within QCom using ALT-O.
  129.  
  130.  
  131.  
  132. CONFIGURATION CONTINUED...
  133.  
  134.     NOTE:
  135.     The "|" character will send a carriage return to the modem.  The
  136.     "~" is a half-second pause to allow the modem time to execute the
  137.     commands in the initialization string.  Some modems need more time
  138.     than others.  The pause is executed by QCom and the modem will not
  139.     actually receive the "~" character.
  140.     Function key definitions are shown in the last ten lines.  You can
  141.     configure your own "macros" here.  Control codes can be sent with
  142.     the use of the "^" character.
  143.     Example:
  144.           ^[ = an escape character
  145.           ^M = a carriage return
  146.     Refer to any good ASCII chart for others.
  147.  
  148.  
  149.  
  150.   COMMANDLINE PARAMETERS:
  151.  
  152.     In addition to specifying a script,  the user can specify an
  153.     alternate configuration file and an alternate phone directory file.
  154.     This allows network users to have CFG and FON files tailored to
  155.     their individual needs.
  156.  
  157.     Switches are:
  158.            /S = load and execute script file
  159.            /C = load alternate configuration file
  160.            /P = load alternate phone directory
  161.  
  162.     Usage is: QCOM [/Sfilename.SCR] [/Cfilename.CFG] [/Pfilename.FON]
  163.  
  164.     Users may use the options in any sequence.  The switches (/S,/C,/P)
  165.     must NOT have a space preceding the filename.  When the commandline
  166.     options are not used, QCom defaults to QCom.CFG and QCom.FON.
  167.  
  168.   TERMINAL EMULATION:
  169.  
  170.     This version has built-in support for ANSI-BBS and straight TTY.
  171.     Pressing ALT-K will toggle between the two.
  172.  
  173.  
  174.  
  175.  
  176.   STATUS LINE EXPLANATION:
  177.  
  178.     ----------------------------------------------------------------------
  179.     Alt-Z:Help │SEC │ Host system name     Online 05:55:55 │Z│ COM1:2400N8
  180.     ----------------------------------------------------------------------
  181.         |       ||||         |                |       |     |       |
  182.         |       ||||         |                |       |     |       |
  183.     Commands    ||||         |                |       |     |       |
  184.     Script on -- |||         |                |       |     |       |
  185.     Echo On ----- ||         |                |       |     |       |
  186.     Capture On --- |         |                |       |     |       |
  187.     Alarm Off -----          |                |       |     |       |
  188.     Host name ---------------                 |       |     |       |
  189.     Carrier status ---------------------------        |     |       |
  190.     Time connected -----------------------------------      |       |
  191.     Transfer protocol --------------------------------------        |
  192.     Communication port, baud, parity and databits ------------------
  193.  
  194.  
  195.   FILE TRANSFER PROTOCOLS:
  196.  
  197.     Transfer protocols are what DSZ uses as a method of flow-control and
  198.     error-checking when transferring files.  These protocols are
  199.     specified when adding to the Dialing Directory.  The Dialing
  200.     Directory is displayed when you press ALT-D.
  201.     The use of ZModem protocol is recommended if the host computer has
  202.     the option available.  QCom defaults to ZModem with crash recovery
  203.     and Moby Turbo enabled (z-rm).  This can be changed by bringing up
  204.     the configuration screen with ALT-O and editing the default ZModem
  205.     line.
  206.     When selecting XModem protocol, QCom defaults to using the built-in
  207.     XModem instead of DSZ's. This can be changed by editing the
  208.     appropriate line in QCom.CFG (press ALT-O in QCOM).
  209.  
  210.     If it becomes necessary to change your transfer protocol while on-
  211.     line, you can do so by pressing ALT-T.  A box will pop up to allow
  212.     you to make the change.  The current protocol is displayed in the
  213.     right-hand box on the status line (see STATUS LINE EXPLANATION
  214.     below).  It is VERY important that the protocols at the receiving and
  215.     transmitting ends are the same, otherwise DSZ will